Memorandum 6M-5097-I 
Sheet 1 at 20 Sheets 



SUBJECT: 

To: 

Prom: 

Date: 

Approved: 



Division 6 — Lincoln Laboratory 

Massachusetts Institute of Technology 

Lexington 73, Massachusetts 



TX-0 DIREGT INPUT UTILITY SYSTEM 

Distribution List 

John T. Gilmore, Jr. 
3 October 1958 



ABSTRACTS Large high speed memories have arrived. Many of our present 
procedures were bom of necessity because of limited storage. 
It is time to review our present techniques and philosophies 
in planning and programming conrputer applications. At 
present we write programs which perform complicated and 
monotonous tasks efficiently and rapidly. But writing and 
debugging these programs are also complicated and monotonoTis 
tasks. Now that we have larger memories, why not try writing 
programs which will help us with our dirty work? This memo 
describes a utility system which is basic in foim but unique 
in the sense that it assists the prograiamer in debugging and 
modifying his program at the console. This is accomplished by 
moving the utility system into memory gaongside the program to 
be debugged and providing direct communication between the 
utility system and the programmer. 
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TK~0 ±B @£i experimental eoispmtex: i?'hicli ims built to test transistor 
eirc^iitry and a 2^6x2^6 xaagi^tic ©or@ memory « Its termiiml equipment 
consists of a pkoto-electric paper tape reader^ a paper tape p\mck^ an 
oscilloscope, and an input-output Flexowriter typewriter • Additional 
equipment sueM as siagnetis tape^ high speed printers ^ ete.^ will be added 
at a later dateo Since It is a- test cos^uter^ most of the coo^uter time 
is dsToted to marginal checking and the operation of test programs. 
Ho«?e-¥-er; the fact that such a large internal memory of 65^^36 registers 
noir exists prooipted us to try some n<m programming techniques in the 
time aTaiJ^ble between test operations = 



One technique was to use the bulk of the memory as a secondary 
storage mediiM instead of magnetic drums or magnetic tapes « Wes Clark 
wrote a conversion program using this idea« The result was a fast comrer- 
sion process oM. one which could translate a flexible symbolic language. 
For example j, address tags^ address sections of instructions, and cooatanta 
can now be expressed as English words as well as, code letters and maBer- 
als» The conversion program has no tape scanning problems and can look 
at the i^ole program to be convertefi as many times ' as necessary in a Tory 
short period of timeo A memo descril^ing th^ rules of the conversion 
program "s vacabulary is bei^ written by Wes and should be available 



Another valuable teehnique which will be described in this 
is that of moving a coEocplete utility system into memory (see Figure l) 
as well as the prog2?am (or pr©g3?ams) t© be operated and debugged* Using 
the input-output Flexowriter typewriter as a means of comrnimieation with 
the utility .systea,debiigging at the console .should be reasonably .single 
asd convenient o 

Debugging at the console 'Is not new. In fact^ it is the oldest 
form of debugging o For the past few years it has been regarded as a 

great professional sin, but like most sins, it still exists, is rarely 
talked about, and hardly ever admii^tedo High costs and inefficiency 
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are the main reasons why It is condemned. At the present time most com- 
puters rent for approximately three himdred dollars per hour. The time 
saved by debugging at the console of the computer is usually far less 
valiiable than the cost of the additionsuL computer time. The second 
reason is that at present, it is extremely difficult to get an objective 
view of what a program is doing or has done while at the console. An 
attempt to find out usually reqiiires manual switch settings, limited ex- 
aminations by piish buttons, or trace program data which is not immedi- 
ately available. A parsuLlel argument is that thinking tmder pressure 
promotes poor reasoning and lots of bad guesses. The general result is 
wasted time debugging time as well as precious computer time. 

In the face of these arguments, why try to encourage or develop 
techniques for deb\igging at the console? Because in certain situations 
and applications the time between the instant that the first instruction 
is written and the moment that the results are produced, are of the ut- 
most importance. In such cases any time is more than worth the addition- 
al rentsil cost. Data Processing, Operational Research, and Real Time 
problems are rapidly producing more and more situations like this. Al- 
thou^ these critical situations will involve only a small percentage 
of the programs being operated on a given computer, utility systems 
must be avilable to handle them . 

There is still the problem of the programmer thinking on his feet, 
trying to find what went wrong with his program and how to modify it. 
It is this phase in which we are ext]remely interested. 

At the present time most utility programs do not provide enough 

immediate information to enable a programmer to find his erroe ^ile he 

is still at the console. And if he can find it, few systems are capable 
of allowing him to make an immediate change without the preparation of 
a card, paper tape, or some other secondary input medium. 
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especially if he wants to retain the spi'bolid language of the conversion 
pro^amo Mother handicap is that he cannot examine ejay given part of 
his program without haviiig previously prepared a request card or tape. 
And finally^ the use of 1p»ice programs is desirable only to the extent 
that they are simple eno^igh to invite their use by the programmer* A 
tracing program that can give a visual picture of what a program is doing 
is of much Daare value thaa one which produces reams of printed information. 

11* I I ■ II I . m ill n II II 1 I I I , 

Our first ai4 most important reason for writing a direct utility sys- 
tem was to determine whjdi^liroatiLxies wouM he most tuseful in assisting a 
programmer at the console. We therefore began with a minimum of speci- 
fications, ^e programming language was restricted to absolute addressed 
instructions and constants. This does not prevent a ^•O prograzmaer from 
writing his original program in relative foxm« !I%ie conversion program 
written by Wes Clark has a very flexible language and permits one to 
obtain an absolute addressed translation of a program which has been 
written in relative form. Later ^ when we have determined what the ideal 
direct utility system should contain we will include a more flexible pro- 
gramming language* 

At the present time the system contains over a dozen routines. Some 
of them are very necessary and others provide services whose only iiripor- 
tanoe lies in the fact that they reduce impatience on the part of the pro- 
grammer. Each routine obtains its reqtiired infoxmation by asking speci- 
fic English questions on the console typewriter. The answers are typed 
on the same typewriter by the programmer and may be English words or nimi- 
bers depending on the natt^e of the question asked. 

Expedite 

The system was designed around a master dispatch routine called 
EXPEDITE i. Its job is to read the Flexowriter coded symbols coming from 
the typewriter and recognize English words. There is a small English 
vocabiilary in the system and each stored word has an instruction associ- 
ated with it. This instruction tells EXPEDITE what to do once an ii^coming 
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word bas been recognized. Most of the words are the names of the other 
routines in the system and the associated instructions inform EXPEDITE 
iAi»T€ the routines stmrt. EXPEDITE not only acts as a dispatcher but is 
also used by the other routines as a subroutine when they require English 
answers from the console. Whenever a word is received which is not listed 
in the vocabulary, EXPEDITE informs the typist of the error. Also, should 
BXPEDI15B receive its own name it will print out the words in its vocabu- 
lary. 

The qonVersion program of the system is called HARK. Using EAHfC 
the progranaaer is able to call for specific registers for examination and, 
if necessary, modification. When an examination is requested, HARK trans- 
lates the bihary contents of the requested register into an octal addressed 
instraction. If the register contains the binary form of an operate - 
class command for ^ich there is a three letter mnaiflonic code, HARK will 
type out the three letters which represent that operate-class command. 
When a modification is desired, the programmer may type the change as an 
octal instruction, a coded operate-class command, an octal number, or any 
combination of these three as long as they are separated by plus or minus 
signs. (Part IV provides explicit typing instructions.) Certain 
control keys of the typewriter allow a programmler to examine and modify 
a series of registers very rapidly. When i^ is desirable, HARK will 
provide a binary punched record of the modifications (in Read-In Bfode 
format). HARK is also capable of recognizing a request to transfer control 
to any register in the program being debugged. When the programmer is 
through with HARK, the Stop Code button is pressed and EXPEDITE is ready 
to receive the name of another requested routine. 

Prince 

Every utility system must have a storcige print-out routine. Ours is 
called PRINCE. It requires three pieces of information from the programmer 
They ares 

1. The kind of page layout. 

2. How the; binary contents of storage are to be translated. 

3. What range of storage is to be translated and printed. 



6m- 5097 ^ 5- 

To determine the kind of page layout PRIHGE types, DO YOU WAHT VER- 
TICAL COUJMN LAYOUT. The answer "YES" infoms PRINCE that each printed 
page is to contain two columns of words. Each column will be 100 (octal) 
words long and the address sequence will run down the left column and then 
down the right- PRIHGE will also lay out each page so that the address 
of the first word position in the left column will have a factor of 100 
(octal). If the first word to be printed does not have an address with 
a factor of 100, PRIHGE will print the first word in the left column rela- 
tive to its position from- the last address with a factor of 100 <» For 
exaB5)le, if the address of the first word to be printed is 507, PRIHGE 
will skip the first seven positions in the left column before printing 
the contents of register 507. In this way each page is laid out in a 
uniform manner* If "NO" is the answer to the first question, PRIHGE 
will lay out 10 (octal) words to a line and 2 words per page. Although 
the vertical column layout printing time is longer than the horizontal, 
it is more popular because it has room for comments and is laid out in 
the way in which most programs are written. Since PRIHGE has only two 
kinds of page layout the answers "^^^ or HO are sufficient » If more lay- 
outs had been available the question would have been reworded and the answer 
would have required specif ic English word(s)ji e.go, DOUBLE VERTICAL, 
SINGLE VERTICAL, HORIZOHTAL, etc. 

DO YOU WAHT OCTAL INSTRUCTIONS is the next question. "YES", is ob- 
vious, "HO", will inform PRIHGE that each register in the range is to 
be translated as a constant. 

The range is determined by the questions, WHAT IS THE FIRST ADDRESS 
TO BE PRINTED, and WHAT IS THE LAST ADDRESS. An octal address is required 
by the programmer after each question has been typed. It is interesting 
to note that PRIHGE uses EXPEDITE as a subroutine when it requires an 
English answer and HARK when it requires a nxm^rical answer. 

Following the reception of the last address to be printed, the range 
is printed out in the desired form. When the range has been printed 
PRIHGE asks, IS THERE MORE TO BE PRINTED. "YES", returns control to the 
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first question again. "NO", returns to EXPEDITE o 

Punchy 

In order to allow the programmer to retain a corrected binary record 
of his program, we have included a storage p\inch-out routine called 
PUNCHY, The first question asked by PUNCHY is, DO YOU WANT A TITLE , 
"YES" , will cause the question, WHAT IS THE TITLE. The programmer then 
types ^at he wants labeled on the beginning of his tape. For example, 
SAMPLE TEST PROGRAM 25 FEBo 57. "NO", will bypass the title question and 
lead to the question that follows the title pimch-out, namely, DO YOU 
WANT THE NORMAL INPUT ROUTINE LAYOUT a "YES", will remind PUNCHY to punch 
out the Input Routine on tape in Read- In Mode format before punching 
the requested range of storage in the noimal Input Routine format. "NO", 
will inform PUNCHY that the range is to be punched out in Read- In Mode 
format. A FUNCTIONAL DESCRIPTION OF THE TX-0 COMPUTER (6M-4789), explains 
the difference between the two kinds of binary layout. The Read- In Jfode 
format is better for short ranges. The next twc questions ask for the 
first and last address of the range to be punched out. The range is then 
punched out and then the question, ARE THERE MORE BLOCKS TO BE PUNCHED 
OUT, is asked. "YES", returns control to the questions asking for range 
addresses. "NO", causes the question, WHAT IS THE ADDRESS OF THE START- 
ING INSTRUCTION, to be asked = After an address has been typed by the 
programmer, the question, DO YOU WANT THE COMPUTER TO STOP AFTER READING 
IN THIS PUNCHED PROGRAM, is typed. "YES", informs PUNCHY to p\mch out 
the starting instruction in a form which will cause the Read- In Mode 
or the Input Routine to stop the computer before transferring control to 

the indicated address. "NO", will cause the opposite. Once the YES or 
NO has been received by PUNCHY, the starting instruction is punched out 
in the desired form and control is returned to EXPEDITE, 

R And Me 

The system contains a read- in routine similar to the Input Routine 

described in 6U-k'jQ9o When EXPEDITE receives an R followed by a carriage 
return, control is transferred to the input routine. Once R has read in 
a tape, the routine will print either GO TO of SUM ERROR, depending on 
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whether or not the tape was read in correctly. In either case control 
will be transferred "back to EXPEDITE so that a prograffimer can call for 
any one of the various routines in the system before operating his pro- 
gram. When he is ready to operate his program^ the word ME will tell 
EXPED33JE to transfer control to the starfcing instruction which was on the 
end of the last tape read in by E. 

Surprise 

The SUBPRISE routine is a useful one which reviews all the registers 
of a given program and types out the addresses of those registers whose 
ccmtents have changed from their original form. It is called SUBPBISE 
because the iz^ormation it produces usually comes as a big surprise to 
the prograiamer. 

After a progrsp has operated and erred^ the binary tape is again 
placed in the photoelectric reader. EXPEDITE is given control and the 
word SUBFEISE is typed by the programmer. The tape is then read in by 
SURPRISE and the address of each register whose contents have changed is 
typed out along with the present contents and the original contents 
(translated as octal instructions or coded operate class coiamands). The 
original contents are restored in each case and when the tape review has 
been ccnipleted; control ia transferred back to EXPEDITE. 

Find 

FIHD is a routine which was bom when we started to combine several 
programs in storage .^ We found that redundancy and confusion resulted 
when two or more programs were formed in memory. Areas which appeared 
to be enpty were being used by other programs for ten^orary storage and 
programs were killing each other by store instructions or Just strolling 
throxigh certain crucial routines. We wrote FI^ to help us find and avoid 
these difficulties. Its usefulness to a programmer probably depends on 
the length of his program and the niMber of small routines used, to btiild 
it. FIND begins by typing the question, DO I0U WAHT TO FIND A WORD, 
BEPEBENCES TO AN ADDRESS, OR SEARCH FOR AH OUTLAW Tim IHSTRUCTIOI}. The 
three possible answers are WORD, ADDRESS, and OUTLAW. 



Word - When WORD is typed, FIND returns with, WlAI IS THE WORD. The 
tonmrev amy he an octal instjruction, a coded operate-class command, an octal 
aiiHiber, or aaay ccaahination ©f the three as long as they are separated by 
plus ©r mimus sig&Sc FIND then searches the whole ©f Memory (20 seeoads) 
mad types out the addresses of those registers which contain that word. 
Whaa all of memory has been examined, FIND returns cwitrol to EXPEDITI. 
If BOthing is found, FIND will print NO ADDRESS before returning control 
to WXPrniTE. 

Addreas - When ADDRESS is typed by the programmer, FIND returns with, 
WHAT IS THE ADDRESS- The answer must be an octal number. FIND searches 
tho vhole of memory and types out the addresses and coateats of those 
regjiaters whose address sections agree with the address specified by the 
programmer. When all of memory has been examined, FIN© will return coa- 
trol to EXPEDITE. 

Qqtlaw - Have you ever had a program stop in some section of memory that 
was aot even part of your program — or worse still, foiiad it sitting stlXl 
in a block of registers which contained constants instead of instructioaat 
How it got there is a good question, and usually a hard one to answer, 
siaco it probably did not ccaiie to a. complete stop as sooa as it left your 
program. When OUTLAW is typed by the programmer, FIND returns with, 
WHKBE BIB YOUR PROGRAM STOP. An octal number is required. As soon as 
FIHD receives the address it examines that register and those that precedo 
it. Xt doubles back through storage until it finds an instruction or set 
of iaatructions which would cause an unconditional control transfer. Tho 
address given it by the progranaaer and the address following the uncondi- 
tional transfer constitute an area which cannot be penetrated by control 
except by the use of a transfer control instruction. FIND then searches 
tho whole of memory and examines each transfer instruction's address 
section. If the address section's value falls within the area in quea- 
tioa, the address of the register and the transfer instruction will be 
priated out. When all of memory has been examined, FIND returns coa- 
trol to EXPEDITE. If nothing is found, NO ADDRESS will be printed 
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before returning control to EXPEDITE. 

Flow Chart Display 

We mentioned earlier that we felt it was desirable to have a trace 

program which was able to give a programmer a visual picture of what his 

program was doing while he was at the console. The system has a routine 

which does this in a limited way. It is rather primitive but it may give 

an idea on how to accomplish the desired result. We call it The Flow 

Chart Display Subroutine. It performs two functions, the first of which 

is to display the four sides of a given box in a given area of the display 

scope. The second functiaa is to keep a record of the sequence in which 

requests were made for all boxes . When the subroutine is requested the 

main parogram must supply tairee pieces of information, namelyg 

le The x,y coordinates of the lower left comer of the box to be 
displayed. 

2. The width and height of the box. 

5. The Flexowriter code for some letter or numeral which the sub- 
routine can use to identify this specific box. 

The purpose of the subroutine is to indicate the control path in a 
program to be debugged. This is accomplished by first dividing the 
program into sections and drawing a flow diagram in which each section 
is represented as a box. The diagram must be drawn on transparent paper 
superimposed on a TX-0 Octal Graph Chart (see figures 3 suad k)> When the 
diagram is cooipletedL the programmer notes the coordinates and dimensions 
of each section's bc^ by referring to the Octal Graph Chart. In writing 
his program, he wilL insert a transfer control instruction to the Flow 
Chart Display Subroutine followed by the necessary information before 
each section's list of instructions. When the program is ready to be oper- 
ated, the transparent copy of the flow diagram is placed on the J"€u:q of 
the oscilloscope. During the operation of the prog^lun, as ^6Ch soction 
is performed, its ccarresponding box on the flow diagram will be illumin- 
ated. In this way the programmer will be able to follow the control path 
through his programo The nusiber of times a box is illuminated for one 
operation of the section it represents, can be controlled externally 
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(by fflsaas of the toggle switch »ectaBulator ) . This allows the programmer 
to control the speed of his pictxire or to shut it off corapletely. 

Path 

When the program has stopped, the prograaimer may obtain a printed 
record of the sequence in which the sections were performed. This is 
done by transferring control to KXPBDITB and typing the word PAfH. The 
result is a printed sequence of alpha numeric symbols (81 per lime)- 
When the print-out is coo5»leted, FIHISHED is typed by PAIH, and control 
is retximed to EXPEDITE. 

As an example, the boxes on the flow chart of figure k were lettered 
a,b,c,d,e,f ,g,h,l,r,m, and s. A printed seqjuence from PATH mii^t ^pear 
as: 

abcdrmgcdrmgcdimgcldz'mgcldrmgcdefgcdefs 
finished 



Be Brief 

Once a programmer has become familiar with the questions of each routine 
there is no need to continue the lengthy wording of each question. When 
BE BRIEF is typed by the programmer EXPEDITE will reduce each question 
in every routine to one or two words. When it has completed this task 
and is ready to receive title requests a^dn, it informs the prograaaer 
by typing XSS SIR. 

Ill SOBROUTIKES 

In writing the Direct Input Utility System we made an effort to in- 
corporate as many subroutines as possible. This was done for two reasons. 
First, it makes the Job of modifying the system much easier, and second, 
it privides a few subroutines that a programmer can use in his oim pro- 



Each subroutine has been written so that it must be entered with 
a transfer control instruction in the accumulator. The address section 



of this instruction should contain the address of the register where 
control is to be returned when the subroutine has eanpleted its task. 
Unfortunately, TX-0 is such a simple machine that it does not have the 
equivalent of a Whirlwind A Register, Therefore, it is necegsary to 
program the return address when using subroutines. But since the compu- 
ter and this system only exist to discover new potentials from large mem- 
ories, we have no reason to conqplain. TX-2> the eventual home of our 
large memory, is a very efficient comrputer in every respect . The ideas 
developed on TX-0 will be that much more powerful on TX-2. 

The following is a list of subroutines in the system which may be 
tiseful in other programs written for TX-Os 
I. Storage Print-out 

A. Vertical column layout 

1. 2 words/ column, 2 columns/page 

2. initial conditions 

a. 175560 « +0 SB instructions 
175560 ss -0 B octal numbers 

b. 175561 a first address of range to be printed 

c. 175562 « last address of range 

5. Starting address of subroutine « 175525 

B. Horizontal layout 

3 6 

1. 2 words/ line, 2 lines/paae 

2. initial conditions 

a. same as for Vertical Column Layout 
5« Starting address of subroutine = 172767 
II. Computer Word Print -out 

A. Instructions 

1. initial conditions 

a. 1775^1 * word to be translated and printed 

2. Starting address of subroutine « 17511i.O 

B. Octal number (address) 

1. initial zero suppression 



2« Initial co]iditio&s 

a. 17733.7 « word to be traailated and printed 
5. Starting address of subroutine » 177370 
C . Octal libber 

1. All six digits are printed 

2. Initial conditions 

a. 177337 « word to be translated and printed met 

3. Starting address of subroutine « 177710 
III. English Word Printer 

A. See appendix for list of English wordli available afid their 
corresponding addresses. 

B. The addresses of the words to be printed must be stored 

in the registers iiamed;Lately folloving the transfer control 
instruction to this routine. The return address amst be the 
address of the register following the register e^fttaiainft 
the address of the last English word to be printed. 

C. Starting address of the subroutine • 173700 

D. Exaioples print VHAT W YOU VAHT and m carriage retiam 

WHAT « 17^^311 

m « 17^23^ 

YOU « 17^237 

WAHT « 17i^2^3 

CAR BETUB» « 17^231 

Absolute Address Progremming 8yft>oIie Programming 

100| cla question, cla 

add 200 add) tn4an8wer 

tm 173700 tm English 

17^^311 what 

17^3^ 4 o 

17^*237 you 

17^2^3 want 

17^231 car return 

IM>\ cla answer^ cla 

etc etc 

etc etc 

20o| tm 110 English » 173700 



Hote: The TK'-O Conversion Program written by W#« tW^ 

knows the addresses of all the words in tl^e vocabu- 
lary of the system. This is achieved by a Flezovriter 
dictionary tape. Bach w«vd on the t^pe has a space 
separating each letter so that should there be a 
redundancy between an English word to be processed by 
this subroutine, and one wliich the programmer is using 
as en address tag, the conversion program will not be 
confused; i.e., t' e s t vs. test. 
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IV Conqputer Vord Header (HABK) 

A* HilB subroutine will read one word terminated by a carriage 
retorn or tab. 

B« The binary translation of the word will be in register 

176757 when control is transferred back to the main program. 

C. Starting address of the subroutine « 176355 

V. Word Answer Reader (EXPEDITE) 

A. This subroutine will read a YES or NO teztainated by a carriage 
return or tab. 

B. Begister 173322 will contain a +0 for TES and a -0 for NO 
when control is returned to the main program. 

G. Starting address of the subroutine « 173307 

S* Other English aziswers must be programmed and their words 
added to the vocabulary of EXPEDITE. 

XX, Storage Pmeh-out 

A* Bead-In Mode Format 

1. Initial conditions 

a. 172506 m first address of range to be punched out 

b. 172510 * last address of range 

2* Starting address of subroutine « 1720^1 
B* normal Ii^ut Boutine Fonoat 

1. Initial conditions 

a. 17250it a +0 a Input routine will be punched out 

first in Head-In Mode Format be- 
fore range is punched out. 
-0 a na Inputs Houtlne leader. 

b. 172505 « first addresa of range to be punched out 

c. 172507 *" liLst address of range 

2. Starting address of subroutine a 172IOO 

C. Starting Instruction Punch-out 

1. Initial conditions 

a. 172511 a «dd (st&rtlng^ Instruction address) if stop 

a tm (starting" instruction address) if no 
stop after read-in is desired. 

2. Starting address of subroutine a 172205 
B. Blank tape feed-out 

1. This routine feeds out six inches of blank tape. 

2. Starting address of subroutine a 172213 
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VII. Flow Chart Display and Sequence Record 

A. Seq^uence reset subroutinft 

1. This routine is used when a new sequence is %o be 
remembered. It is uiSually requested once at the be- 
ginning of a program. 

2. Starting address of the subroutine « 1712^ 

B. Flow Chart Display 

1. This subroutine illuminates the boxes of a transparent 
copy of a flow diagram which is moimted on the face of 
the display scope. It also remembers the sequence in 
which the boxes were illuminated. 

2. The three registers following each transfer control 
instruction to this subroutine must contain the follow- 
ing: 

a. First reg « octaL values of the x,y coordinates of 

the lower left comer of the box to 
be displayed, e.g., if x ■ 10/ and 
y « 500, then 1st reg. » 010500. 

b. Second reg » octal vmlu£s of the width and height 

of the box to be displayed, e.g., 
if width « TO, and height « 50, then 
2nd reg. • 070050. 

e. Third reg « flexowriter code for letter or numeral 

used to identify the box being displayed. 
The code is written as a six digit octal 
number. e*g., if letter « r, 5rd reg.» 
010100. 

5. The return address must be the address of the fourth regis- 
ter following the transfer control instruction to this 
subroutine. 

4. Starting address of the subroutine « 17IOOO 

5. Bxaagple: Consider the program flow chart of figure k. 
Let UB assume that w^ are going to write the request 
which win display the box that represents that section 
which does the indexing and ccnopares XL and XK. The 
request is written ih the program Just before the 
instructions which actually do the indexing and compar- 
ing. The coordinates of the lower left comer of the 
box are -40, -510. The width of the box is 100 and 

the height is 70. The Flexowriter code for g is 110100. 
The request in instruction form would be: 
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100 




These instructions would 
contain the instructions 
for indexing the values 
and coMparing XL and XK. 
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Sequence Print-out 

1. fhis subroutine will print out the letters aad numerals 
which represent the various sections of the i^ogram in 
the sequence that they were performed. 

2. Using this routine, the se^luence may he printed oat at 
any time during the operation of the prograa. If it 
is not desirable to continue remembering the whole se*- 
quence then this routine should be followed by the 
Sequence Reset routine « 

5. Starting address of the subroutine » 171257 
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PART pf Typing Directions 



TO u»0 the Direct Input Utility System of TX-^O, reard 
in tape no ^ 18 (latest mod). Be sure the TYPE IN switch 
is in the on position and start the program at register 
175100 o This will transfer control to EXPEDITE which is 
the title-read routine for the System* If you are not 
acquainted with the nasies of the other routines ,, type 

expedite and a carriage returno 

This will cause the computer to type out the list of 
the names .e^g^ 

expedite -) 

bebrief 

word 

address 

find 

hark 

surprise 

outlaw 

punchy 

prince 

yes 

no 

expedite 

me 

r 

pstth 

If a name is typed incorrectly or is not in the above 
list^ EXPEDITE will inform you of the fact* For example^ 
let us assume that you typed 

be breif and a carriage return^ 

Spaces and upper and lower case are ignored but 
misspelling is not anticipated o Therefore EXPEDITE 
would have typed out the following: 

error bebreif 
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HARK ^ 

TO transfer oontrol to the syBtem s oonversion 
progranif type 

hark and a carriage return* 

cage 1 , TO EXAMINE A RBOJSTERj 

Type the address of the register^ a vertical bar 
and an equal sign. HARK itlll type out the contents 
of the register as an octal Ins true tlon« a tab^ 
and then wait for a modification* Since no 
modification Is to be madej the typist will type 
a carriage return and precede to examine some 
other register, e.g. examine registers 17^ and 300. 

17^ -Add 177 ^^ ^ p'^' 
typist HARK typist 

30Q| - shr ^ 

''^ <^ • " III '^ 



typist HARK typist 

case 2 4 EXAMINE AND MODItY A REGISTER 

Octal Instructions J coded operate class command 8# 
octal numbers 4 and any co^lblnatlon of these three 
separated by plus or minus signs may be used to 
express a modification, e.g. change register 17^ 
to contain add 137 • 

17^1 «^^dd 177 -^j 

typist HARK 

Case 3 * MODIFY A REOISTER WITHOOT EXAMINING IT 

174| add 157, ^ 




^ 

typist 



Case 4 . MODIFICATIONS OF A SERIES OF REGISTERS 

174| add 157 
»to 300 
4-234 

In this case registers 17^*175* and 176 would have 
been changed to add 157^ sto 300^, and +234» Each 
time a modification is typed and terminated the 
current address in HARK is Indexed by one. Extra 
carriage returns and tabs are Ignored. 

EXAMINATION AND MODIFICATION OP A SERIES 
OF REGISTERS 

17^1 » add 177 ^ 



typist HARK 

175lj^ ^feo 301 
typist HARK 
176| « ,8to 230 
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typist HARK 



typist 



Using the carriage return to terminate a raodiflGation 
you can see that it is necessai*y for the typist to 
type the next address and an equal sign in order to 
obtain the examination* This is not necessary if the 
modification is terminated by a period, e.g. 



17^ « add 177 
typist HARK 
sto 301 




add 157. 



typist 
sto 300« 



/ 



sto 230 



sto 400 



HARK 



typist 

+2340 

typist 

p 

typist 



4? 

HARK 

HARK 
P 
HARK 



The period will cause HARK to store the modification, 
produce the carriage return^ type the next address > 
the vertical bar^ tlcm contents of the register, a tab, 
and then wait for another modification from the typist. 
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case 6 o EXAMINATION OP A SERIES OF REGISTERS 

The period is also helpful whan a series of 
registers is to be examined without modifications. 
When HARK receives a period from the typewriter it 
checks to see whether a modification has been typed • 
If a modification has not been typed HARK will merely 
produce a carriage re turn ^ type the next address, a 
vertical bar^ the contents of the register, and a tab. 

^i7H=='add 157 -"A , jP 
1751 - sto 300 ^ni . ^ 
1761 - sto 23^ 




HARK typist HARK 

case To A SEARCHING EXAMPLE 

Using the period it is quite simple to search a 
given set of registers and then modify the desired one 
por example If an entry in a table was to be chsuiged 
it would not be necessary to know Its exact location. 
One would merely type the first address of the table 
and search for the entry by typing periods. Of course 
if the table was extremely long the PRINCE would be 
used instead e Let us assume that we want to search the 
table beginning at register 2000 and that we want to 
change the first register containing a minus zero to 
a one, .ry^-i' 



goog^jsto 125 '^ o ^ 

200^ sto 100 -^** o *P 

2002 = sto 5 -^^ o tP 

2003 = opr 177776 '^ o ^ 

2004 = opr mill -^ +1 ^ v_-^.-^ 

HARK typist HARK 

case 8 o EXAMINATION^ MODIFICATION i, AND RECORDING 

The comma performs the same function as the period 
but also enables the typist to obtain a punched binary 
tape record of his modifications , When a modification 
is terminated by a comma HARK stores the mod, in the 
indicated register^ punches the binary form of the 
current address on tape^, punches the binary form of 
the modification on tape^, produces a carriage return^, 
types the next address ^ a vertical bar^ an equal sign, 
the contents of the register^, and a tabo 
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case 8 continued • 

Let us assume that we had to make modifications to 
registers 17%, 175* and i76 and that we also wanted a 
binary paper tape record as wello 

( 1741^ add 177 ^ add 157. 4P 

1751= »to 301 y^ sto 300, ^ 

1761 = sto 230 ^ +234, ^ 

1771 - sto 4 00 ^ ^ 

HARK typist HARK 

The paper tape would contain the following s 

plrst three lines- sto 174 

next three lines=s add 157 

next three lines* sto 175 

next three lines= sto 300 

next three lines- sto 176 
next three lines* +234 

This kind of layout is called the Read-In format and 
is dlscribed in 6m-4789. A FUNCTIONAL DISCRIPTION 
OF THE TX"0 COMPUTER » 

gaae 9 o EXAMINATION AND RECORDING OF A SERIES 
OF REGISTERS 

This would be obtained by typing a comma in place 
of a period o 

case 10 o RECORDING THE ADDRESS OF THE STARTING 
INSTRUCTION ON PAPER TAPE 

After a series of modifications are made it 
is desirable to record the address of the starting 
instruction o This enables the Read- In mode of TX-0 
to traii«fer control to the program after the 
modifications have been read into storage from tape. 
TO do this VdM typist merely types the address of the 
starting instraotioi^a vertical bar, and a comma. 
e o g o ■'i 

i74| , I 

This will cause the sext three lines on paper tape 
to contain add 174 (t^e add signals the Read- In 
mode to stop the computer before transferlng control 
to register 174) and then HARK will feed out some 
blaink tape. 
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Cggell. TRANSPERINO CONTROL FROM HARK TO SOME 
^^"""^ OTHER REaiSTER IN ME^K)RY 

To transfer control to some other register In 
memory the typist has to type the address followed 
by two vertical bars. e.g. 

±m\ 

case 12 b CONCEALING INFORMATION FROM HARK 

We have found that the typewritten copies produced 
while using Hark have been very useful records. There 
is a feature in HARK which allows the typist to make 
comments alongside any of the examinations or 
modifications without HARK acting on the information. 
Whenever the vertical bar is the first piece of 
information that HARK receives after a terminating 
character, then all the information that is typed 
will be ignored until a carriage return is typed. 
e.g. 

CASE 13 * ERROR RECOGNITION BY HARK 

Whenever an invalid word is typed Hark will Inform 
the typist by typing the word^error and the invalid word 
Some examples of invalid words ares 

i. Three letter combinations for which there 

are no operate class commands, i.e. clu,cpo»Ctc. 

2. Any alphabetical letter Used as a suffix 
to an octal number, i.e. i25j 

3. The use of o and 1 fOr and i. i.e. 2oo 
and 17510. 

4* Two letter designations for the four 

operation symbols, i.e. ad, st, tn, op, etc. 

When HARK does find an invalid word it will not disturb 
the current address when it prints out the error* 

Case 14 . NULLIFY CONTROL 

There are many times when a typist will make a mistaiB' 
and discover it before a terminating character has 
been typed. To nullify the whole word all that is 
required is the typing of a double x. This will erase 
the whole word or address being typed but will not 
disturb the current address. This feature is also 
provided by EXPEDITE. 
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Case 15 o HOW TO TRANSFER CONTROL BACK TO EXPEDITE 
PROM HARK 

To transfer control back to EXPEDITE the typist 
merely has to hit the STOP CODE button on the 
typewriter. This will cause EXPEDITE to guard the 
typewriter for incoming requests for other routines. 

Case 16 . SOME EXAMPLES OP LEGAL WORDS 

We mentioned that a word may be an octal number, 
an operate class command in coded form, an octal 
instruction I, or any combination of these three 
so long as they were separated by plus or minus 
signs o Here are some examples? 

io add 100 +5 -add -110 will be converted to "5o 

2o add+add will become trn 

3o +2-1+100 will become +101 

5c.°'add=100 will become (the coi^lcment of add 100 or) 

trn 177677 « 
5« cla +200 will become opr 140200 

Noteo The addition of two coded operate class commands 
will not become a new combination. including 
the functions of the Jkwa eommands that were 
added together, ooieo cll+clr ;^ cla. 1 

cll+clr « trn 140001. 
6. 125+40I will cause the current address to be l65o 
7« 125+401 I will cause HARK to transfer control to 
register l65o 



SUf®iARy OP TYPING DIRECTIONS FOR HARK 

Current Address — —-——-- — - address] 

Examine Current Address — «-— = 

Octal Instructions™ — — .«-« sto 

add 
opr 
tm 
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Octal Number*"" 



Coded Operate Class 
Commands— "™— --'—'• 



Terminating Characters; 
ie Carriage return— 
2* Tab—™' — 



3<» Period- 



alone 

or followed 

by an 

address 



six or less octal digits 
alone 5 or pre-ceded^y a 
plus or Minus signo 



cla ell clr 

QJX .cyl „AOm,, 

Ipd Iro lad 

shr hit dis 

p6h p6s p7a 

pna pnc rfa 

r3c rle rll 



clc cal 
, Jac. ;jLlr 

tac tbr 

ios p7h 

p6a pnt 

rfl rfr 
rir 



"Iwill store modification in 
"jthe register whose address 
is the current address and 
then index the current 
address by one* If there is 
no modification to be stored 
HARK will ignore the tab or 
carriage return and the 
current address will remain 
the sameo Hark also ignores . 
extra carriage returns or 
tabSo 

" will store a modification 
in the same way as the tab 
and the carriage return do 
but in addition it will 
produce a carriage re turn i, 
print the next current 
addresSi, a vertical bar^, an 
equal sign^. the contents of 
the register whose address 
is now the current address p 
and a tabo If there is no 
modification then none will 
be stored o The rest of the 
sequence will remain the same. 
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SUMHAKY OF T¥PIMQ DIHECTIOHS FOR HAHK coatinxiedo 

Terminating Characters coat^ 

4e eoB!iaa"~'""'°-'-""°"-"=»'='='"~ perform® the sarae function; as 

the period but In addition 
it will record the 
ModlfleatioEi ©b paper tapt 
In the format ©f the . 
Read-=In Mod@o If Eb, 
modificatiom is made them it 
will record the ©rig.|=mal 
contents of the register 
whosie address' i® 'the current 
address and then procede in 
same way. as the period o 

Additional Features 

lo Recording the addresB 
of a starting instruct" 
tion on paper tape"-* ="- address] s 

2o Transferlng control 
to another section 

in BieM©ry-=-='-~-»"^. "'—'=•='- addressj j 

3 6 Concealing information 

from |fAHK'"-"°^"-"=""'^'="=""'?^| infoCTiatlon p 

^0 nullify control—- »-="» xk will nullify a whole 

word or address o^ 

5o Transferlng control 

back to EXPEDITE'-™-'-'*" press the STOP COBE teuttOEo 

Notes HARK will always type in the opposite color cod® 
of the typist o 
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17 IIEAS FCR NEW ROaTINES 

Kb you can see, this utility system is very basic. 

We have nierftly suggested a techiiique which wiH enable a prograjum^r 
to see what his program is doing and examine and modify it rapidly lAiil^ 
he is still at the console. 

There are some new routines being written now i^ich will be added 
to the system at a later date. When we have than written amd operating 
we will write an addendum to this mmo» The following is a liet of ftoie 
of the new routines and changes t 

1. Several display subroutines 

2. The flexo paper tape conversion program written by Wes Clark 
will be added to th« system and wiH include the feature of 
infoxming the programmer of any illegal words on the flexo 
tape and asking him whether he wishes the conversion process 
to be continued with the illegal word (s) ignored or corrected. 
The correction would be added via the direct input flexo 
typewriter. 

3. The direct input conversion routine, HAEK, will have its 
vocabulary increased to understand relative and symbolic address 
tags. 

km In order to assure the programmer at the console that the 

utility systwn has not been damaged by his program, we plan oil 
installing a check routine iriiiich will perf oini a sura check on 
all permanent instructions and constants in the system. 

5» Any suggestions for routines or techniques which would increase 
the efficiency of debugging at the console will be appreciated. 



JTGjbac 




y\j^My^ 



tn^-v"— *C^ 



Attachments: { |John T. Gilmore, Jr. 

Appendix A DL-i; 

Appendix D A-80287 

B-8035^ A-68i^05 
D-80351 
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APPENDIX A 
CODED OPERATE CLASS COMMANDS 



CLA = opr li^-0000 
CLL = opr 100000 
CLR = opr i|-0000 
CLC = opr l40040 
CAL = opr 1^4-0200 
CYR = opr 600 
CYL = opr 31 
COM = opr kO 

LAC = opr 114-0022 



ALR = opr 201 



LPD :! opr 



22 



LRD = opr 200 
LAD = opr 32 



TAG s opr l4000^ 
TBR = opr li}-0023 

SHR = opr 400 

HLT : opr 30000 
DIS = opr 22000 

PEN 5 opr 100 
lOS = opr 160000 
PTH = opr 27600 

P6H * opr 26600 
P6S = opr 166000 
P7A - opr 27012 



Clear the accumulator 

Clear the left nine bits of the accumulator 
Clear the right nine bits of the accumulator 
Clear the accumxilator and complement it 
Clear the accumulator and live register 
Cycle the accumulator one position to the right 
Cycle the accumulator one position to the left 
Complement the acciMulator 

Transfer the contents of the live register to 
the accumulator 

Transfer the contents of the accumulator to the 
live register 

Partial add the contents of the accumulator and 
the live register and leave result in AC 
Clear the live register 

Add the contents of the live register and the 
accianulator and leave result in AC 

Transfer the contents of the toggle switch 
accumulator to the accumulator 

Transfer the contents of the toggle switch b\iffer 
register to the accumulator 

Shift the accumulator to the right one position 
(multiply by 2-1) 

Stop the computer 

Display a point on the face of the oscilloscope 
according to the value in the accumulator 

Read light PEN into Ac^ and Ac^ 

In out stop ^id accumulator cleared 

Punch seven holes on paper tape and cycle AC right 

one position (AC 2, 5, 8, 11, ik, I7 Tape 1 2 

3^56) 

Punch six holes on paper tape and cycle AC right 

Clear AC and punch one line of blank tape 

Punch seven holes and clear AC 



A-1 
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COIED OP£RA!!CB GLASS OOMNAIiBS (CONTHiUED) 



P6A = qpr 26021 
PHT « opr 2^00 

PHA = opr 24021 
PNC « opr 2406l 
RFA * opr 11^1000 
KPL = opr 1031 
BFR = opr 1600 
K5C « opr 163000 

RIC « opr 161000 
RIL e opr 161031 
BIK « opr 161600 



Punch six holes and clear AC 

Priat and cycle right (AC 2, 5, 8, U, Ik, I7 - 
Plexo 1, 2, 3, h, 5> 6) 

Print and leave AC cleared 

Print and clear and cco^leisent AC 

Clear AC and start petr running 

Cycle AC left and start petr running 

Cycle AC xlght and start petr nmning 

Clear AC and read three lines from pt^er tape 
(Tape 1, 2, 3, k, % 6 AC 0, 3, 6, 9, 12, 15) 

Clear AC and read one line from paper tape 

Clear AC^ read one line and cycle left 

Clear AC^ read one line and cycle right 
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ENGLISH VOCABUIARY 
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of the 






TX-0 EHGUSH PRINTER SUBROUTIMB 




a 


17^170 


outlaw 


YlW^ 


address 


17^163 


print 


17^12 


after 


17^561 


printed 


17^537 


an 


17I1.413 


program 


17%120 


are 


xihxoo 


punched 


17^115 


are^ 


17^^27 


question 


17^^55 


be 


17^55^ 


i^eading 


l7i^365 


block 


I7U04 


reference 


17H16 


car return T <? J 


17^^231 


routine 


17ii-271 


coltimn 


17^05 


s 


17^160 


coniiiiA 


I7H1O 


search 


17i^^35 


computer 


17i^350 ■ 


sir 


17^%7^ 


did 


17W6^ 


starting 


Y{k\h% 


do 


17^23^ 


stop 


Yi\-^y> 


double 


17IH73 


tab Lr^ ) 


17%110 


fiiid 


17MfOO 


test 


17413^ 


finished 


17U35 


the 


17^315 


first 


17^^321 


there 


17^301 


for 


17^4^ 


this 


17^125 


In 


17^^372 


title 


1743^ 


iiiput* \ 


17^265 


to 


17^331 


instructi^i 


17^1^7 


tm 


17H51 


is 


17^276 


TX-0 


17^37^ 


last 


17^325 


vertical 


17420a 


layout 


17^2^7 


vant 


17teif> 


more 


17^505 


what 


17^3-1 1 


no 


l7i^226 


where 


171^1*62 


nonoal 


I74a60 


word 


17^404 


octal 


17^25^ 


yes 


17422E 


of 


17^155 


you 


17^237 


or 


17M*.24 


your 


17^74 


out 


171^216 
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000 



(4096) 



10.000! 20.000 



(8192) (12.288)(16.384) (20.480) (24.576) (28.672) (32. 768) (36. 864) (40.960) (45.056) (49, 152) (53. 248) (57.344) (61.440) 



1,000 



2,000 



11,000 



12.000 



3,000 



4.000 



13.000 



14.000 



21,000 



22.000 



30,000 



31.000 



32.000 



40.000 



41.000 



23,000 



24, OuO 



33.000 



42,000 



43.000 



50.000 



60,000 



51,000 



52,000 



34,000 



53,000 



70,000 



61.000 



62.000 



71.000 



72.000 



44.000 



I 5,000 115. OuO 



6,000 



7.000 



16.000 



25, 000 



26.000 



35, 000 



45,000 



36.000 



17,000 



27,000 



37.000 



63,000 



54,000 



55.000 



46,000 



47.000 



56,000 



100.000 



101.000 



102,000 



73, 000 



64,000 74,000 



65.000 



57,000 



66,000 



67,000 



75.000 



103,000 



iiopoo 



111.000 



112,000 



120.000 



121.000 



130,000 



131.000 



140,000 



104,000 



105.000 



113.000 



114.000 



115.000 



122,000 



123.000 



124.000 



132,000 



133.000 



134,000 



141,000 



142,000 



143,000 



150,000 



151.000 



152.1 



160,000 



161.000 
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^i/^i?' 



162,( 



153.000 



144.000 



76.000 



77.000 



106.000 



107.000 



116.000 



117.000 



125.000 



126.000 



127.000 



135.000 



136.000 



137,000 



145.000 



163J 



170.000 







154,000 



164, 




155,000 



146.000 



147,000 



156.000 



157,000 167,01 



165,000 



m 



166,1 
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